home *** CD-ROM | disk | FTP | other *** search
/ HyperLib 1997 Winter - Disc 1 / HYPERLIB-1997-Winter-CD1.ISO.7z / HYPERLIB-1997-Winter-CD1.ISO / オンラインウェア / UTIL / HandyMan 1.4 Folder.sit / HandyMan 1.4 Folder / HandyMan 1.4 / HandyMan.ReadMe < prev    next >
Text File  |  1996-06-07  |  21KB  |  314 lines
  1.  
  2.  ﾊ
  3.  
  4.  
  5. HomePage:
  6.     http://www.club.innet.be/~ind0836/mac/HandyMan.html
  7.  
  8. HandyMan 1.4 (6-6-96) Copyright ｩ 1995-96 Bert Wynants
  9.  
  10.  
  11. Table of Contents
  12.  
  13.     1.    Introducing HandyMan
  14.  
  15.     2.    System Requirements
  16.  
  17.     3.    Installing HandyMan
  18.  
  19.     4.    Using Modifier keys
  20.  
  21.     5.    Advanced Usage
  22.  
  23.     6.    Localization (Catalog files)
  24.  
  25.     7.    The Configuration menu
  26.  
  27.     8.    About the Program
  28.  
  29.     9.    About the Author
  30.  
  31.     10. Acknowledgements
  32.  
  33.     11.    Frequently Asked Questions
  34.  
  35.     12.    Tips And Tricks
  36.  
  37.     13.    Known problems
  38.  
  39.  
  40. 1.    Introducing HandyMan
  41.  
  42. HandyMan is a Control/Desktop/Extensions Strip Launching Module.
  43.  
  44. It is designed to allow quick and easy access to applications, Control Panels, Desk Accessories, Folders and other documents stored on your Macintosh, without having to navigate through several ﾒFinder Windowsﾓ or through a multi-layered, hierarchical Apple menu.
  45.  
  46. It works by clicking on icons installed in a floating window, or dropping documents onto them.  This approach is much handier than aliases that are on the desktop because the floating windows that contain the icons can never be covered by windows.  HandyMan also requires a lot less desktop space than the same number of icons on the desktop.
  47.  
  48.  
  49. 2.    System Requirements
  50.  
  51. HandyMan can run on any Macintosh model, and requires at least System 7.1 and Control Strip, Desktop Strip (version 1.1.1 or higher) or Extensions Strip installed.
  52.  
  53. Make sure the ﾒFinder Scripting Extensionﾓ version 1.2 is installed to work with Folder icons, Trash icons, Control Panel icons, and ordinary documents ...
  54.  
  55. If Drag Manager 1.1 is installed you can drag and drop documents on the applications, folders and Trash icons in the strip (Mac OS version 7.5 has the Drag Manager included).
  56.  
  57. For best functionality you need the ﾒFinder Scripting Extensionﾓ (version 1.2 or higher), ﾒMacintosh Drag and Dropﾓ (version 1.1 or higher), ﾒControl Stripﾓ (version ?.? or higher), ﾒDesktop Stripﾓ control panel (version 1.1.1 or higher), or ﾒExtensions Stripﾓ (version 1.0 or higher) and ﾔApple Menu Optionsﾕ with ﾔRecent Documentsﾕ enabled.
  58.  
  59. Should you have any trouble running HandyMan on your machine, please write to me with the full specifications of your machine and what version of HandyMan you are using, as well as the name and version of the strip module you have installed.
  60.  
  61.  
  62. 3.    Installing HandyMan
  63.  
  64. 1.    Install the Apple Control Strip control panel, or an alternative such as Desktop Strip or Extensions Strip.  If you use a desktop Mac, you must have at least version 1.3 of Apple's Control Strip (earlier versions only worked on portable Macs).  For increased functionality, use Desktop Strip or Extensions Strip.  If you have just installed a strip module, you should now restart (so that the module can be activated).
  65.  
  66. 2.    Place HandyMan inside the Control Strip Modules folder, which is inside the System Folder.  It may be named differently on non-English systems.  If you have used the ﾒAdd Aliasﾓ module from Apple with a previous version of HandyMan, then you should remove it, as it is no longer required.
  67.  
  68. 3.    Restart your Macintosh to install HandyMan.  This restart is not needed for Extensions Strip users.
  69.  
  70. 4.    Configure HandyMan by dropping aliases into the ﾒHandyMan Aliasesﾓ folder, or by dropping files onto the ﾒ+ﾓ icon at the start of each column/row.  If you click on the ﾒ+ﾓ icon in your strip, it will open the ﾒHandyMan Aliasesﾓ folder (or the folder for that column/row if you are using Desktop/Extensions Strip).  Removing icons is done by dragging them to the Trash.  Control/Desktop Strip users have to install an alias of the Trash into the strip because of a drag manager bug (Also see Known problem 2).
  71.  
  72. 5.    If you are using Desktop Strip or Extensions Strip, you can have multiple floating windows.  All you need to do is have multiple folders inside your Strip Modules folder in your System folder.  There will be one strip on your screen for each folder you create.  For a typical setup, you would have one folder containing controls that you would typically put into Apple's Control Strip.  A second folder would contain the Program List module that is distributed with Desktop Strip.  A third or fourth (or fifth) could each contain copies of HandyMan set up in different ways.  A single strip containing an alias of the Trash will always float above other windows, so you can always find the Trash.
  73.  
  74.  
  75. 4.    Using Modifier keys
  76.  
  77. There are a few simple modifier keys that can be used:
  78.  
  79. Text Labels:
  80.  Control clicking on a text label allows you to resize the labels by dragging them Left or Right.
  81.  Shift selecting ﾒShow TextLabelsﾓ from the preference menu puts the labels under the icons.
  82.  Option selecting ﾒShow TextLabelsﾓ from the preference menu shows only the Labels.
  83.  
  84. Trash:
  85.  Option click on the Trash will empty it.
  86.  
  87. Folders:
  88.  Option drop on a folder copies the files to that folder, otherwise they will be moved.
  89.  Control clicking on a folder icon filters out non-folder items from that popup menu.
  90.  Shift clicking on a folder icon filters out folders from that popup menu.
  91.  Control dropping on a folder will force the copy or move to happen (no dialog popping up if the file already exists).
  92.  
  93. Clippings: 
  94.  Shift clicking on a clipping copies it to the clip-board.
  95.  Shift selecting it from a popup menu copies the content to the clip-board.
  96.  
  97. Configuration:
  98.  Option dropping onto a ﾒ+ﾓ icon moves the file into the folder, instead of creating an alias of it.
  99.  
  100.  
  101. 5.    Advanced Usage
  102. Use compiled Apple Scripts, onto which you can drag and drop just like onto an application, to add custom commands to the strip.  
  103. sample usage:
  104.  
  105.     on run
  106.         -- User has clicked the script to run it....
  107.     end run
  108.  
  109.     on open theList
  110.         -- User has dropped files onto script to open them....
  111.             repeat with x in theList
  112.                 -- walk through the list of dropped items
  113.             end repeat
  114.     end open
  115.  
  116.  
  117. 6.    Localization (Catalog files)
  118.  
  119. For Localization HandyMan has support for catalog files.  If HandyMan can find a file HandyMan.Catalog in it's folder or in the preference folder it will use it for translating everything into the language described in that catalog file (Finder Info shows language and version number of the catalog file).
  120.  
  121. If your HandyMan does not get translated you should check that both HandyMan and the Catalog have the same version number.
  122.  
  123. Note: Localization can mean the ﾔRecent Documentsﾕ folder is renamed to match that of the localized system.  If you can't get ﾔRecent Documentsﾕ to work please see the ReadMe in the catalog folder of your active catalog (See also  Enable Items Popup  in The Configuration menu).
  124.  
  125. Check http://www.club.innet.be/~ind0836/mac/HandyMan.html for newer or updated catalogs.
  126.  
  127.  
  128. 7.    The Configuration menu
  129.  
  130. Small icon size
  131. This option is only available in Desktop/Extensions Strip!
  132. This displays small icons, that take up a lot less space on your desktop ﾐ a real space saver.  If you would like mini sized icons, send me a letter with your comments.
  133.  
  134. Large icon size
  135. This option is only available in Desktop/Extensions Strip!
  136. These icons are the same size as normal desktop icons, but they can be a lot closer together.  If you would like mini sized icons, send me a letter with your comments.
  137.  
  138. Show Popup Triangle
  139. HandyMan has the ability to hide the configuration triangle to save some space on your desktop (or because it's neater without that triangle).
  140. You can always use □ click on the module to make it show its configuration menu and change the settings.
  141.  
  142. Show Vertical icon list
  143. This option is only available in Desktop/Extensions Strip!
  144. The list of icons can be arranged horizontally or vertically.
  145.  
  146. Show Multiple Rows/Columns
  147. This option is only available in Desktop/Extensions Strip!
  148. In the Configuration menu you will see either ﾒShow Multiple Rowsﾓ or ﾒShow Multiple Columnsﾓ.  The option displayed depends on how you have set the ﾒShow Vertical icon listﾓ option in the Configuration menu.  To make multiple columns you can put a number of folders in the ﾒHandyMan Aliasesﾓ folder and select the ﾒShow Multiple Rows/Columnsﾓ option.  This way folders are parsed one level deep, folders in those folders don't show up as additional rows/columns but as folders icons in the bar (for more information see the sample pictures included in the Examples document). 
  149. ﾊ
  150.  
  151. To completly suppress the adding of a folder make the first character of its name a ﾔﾂﾕ (Option-L) (e.g. ﾓﾂDisabled Itemsﾓ).
  152.  
  153. Since HandyMan 1.4 you can select the "Add Row" or "Add Column" menuitem for easier creation of multiple rows/columns (see ﾒAdd Row/Columnﾓ).
  154.  
  155. Show InfoBar
  156. This option is only available in Desktop/Extensions Strip!
  157. Let HandyMan tell you what item the mouse is over.
  158.  
  159. ﾊ
  160.  
  161. Show PopInfo 
  162. Text showing the name of the icon under the mouse pops up when you keep the pointer steady over a HandyMan icon for a few moments.  The text always pops up inside the strip module's bounds.  This method requires less screen space than the InfoBar, and works with Apple's Control Strip. 
  163.  
  164. ﾊ
  165.  
  166. Show TextLabels
  167. Icons are shown with the name next to them. 
  168. Option selecting this menu item removes the icon and only a text label will be shown.  To resize the text labels, click in them with the control key pressed.  A vertical line will appear that can be dragged to the left or right.
  169.  
  170. ﾊ
  171.  
  172.  
  173. Desktop/Extensions Strip users can Shift select this menu item to put the text label under the icon.
  174.  
  175. Show Entry Tiles
  176. This option is only available in Desktop/Extensions Strip!
  177. Entries are shown with a small 3D frame. (Including the text labels)
  178. This option is only for nicer drawing and has for the rest no effect whatsoever...
  179.  
  180. ﾊ
  181.  
  182.  
  183. Show Icon Tiles
  184. This option is only available in Desktop/Extensions Strip!
  185. Icons are shown with a small 3D frame and the Icons behave like buttons.
  186. (Clicking anyware in the Icon selects the Icon.)
  187.  
  188. ﾊ
  189.  
  190.  
  191. Show Aliases Folder
  192. A "+" icon is added to the start of the strip onto which you can drop icons to add them to the strip.  With a normal drop, an alias is created, then put in the configuration folder.  If you hold the Option key down while you drop the icon, the item is moved to that location.  If an icon drag is started on the strip, by default, the alias is moved to the new row.  The Option key changes this into a copy.  To remove an icon, drag it to the Trash.  If you are not using Extensions Strip, then read Known problem 2.
  193.  
  194. ﾊ
  195.  
  196. Resolve Dragged Alias
  197. This only applies to installed applications.  It is a toggle for applications to open the alias or the document the alias refers to.
  198.  
  199. Enable Items Popup
  200. HandyMan has the ability to let you select a file that is in a folder from a popup menu.  Enable this option then click and hold over a folder, disk or server icon to see all items.
  201.  
  202. If you have the ﾔApple Menu Optionsﾕ control panel installed and the ﾔDocumentsﾕ option in ﾔRemember recently used itemsﾕ is on, HandyMan will also put up a popup menu.  When the cursor is over an icon of any application installed in HandyMan, the popup will contain a list of the recent files that the application can open.
  203.  
  204. If you use a localized version of the ﾔApple Menu Optionsﾕ control panel and you don't have a Catalog for HandyMan in that language you can make an alias to your localized ﾔRecent Documentsﾕ folder and that alias has to be put into the System folder with the name ﾔRecent Documentsﾕ (or the name described in the active catalog).  If HandyMan doesn't find the ﾔRecent Documentsﾕ in the ﾔApple Menu Itemsﾕ folder it will try to find it in the System folder and will resolve your alias to the correct folder.
  205.  
  206. You can also make the ﾔRecent Documentsﾕ folder yourself and put it in the ﾔApple Menu Itemsﾕ folder or into the System folder.  If you put some aliases to documents in it.  The documents will popup on applications if you click and hold the mouse for a few moments over an application.  You also can lock aliases in that folder to have permanent items.  These will appear first (and underlined) in the menu for easy spotting (See also Known problem 1).
  207.  
  208. Enable Drag Away
  209. This requires ﾒMacintosh Drag and Dropﾓ version 1.1 or higher to be installed.
  210. This option must be on before you can drag items from the strip.  Then you can drag them to the Trash or desktop to remove them from the strip.  This is handy if you have an alias installed for the ﾔFind Originalﾕ script from Apple.  You can drag items from HandyMan to this script, and the script will show you where the original file is located.  If you are not using Extensions Strip, then read Known problem 2.
  211.  
  212. Add Row/Column
  213. In the Configuration menu you will see either ﾒAdd Rowﾓ or ﾒAdd Columnﾓ.  The option displayed depends on how you have set the ﾒShow Vertical icon listﾓ option in the Configuration menu.  If it is not possible (ﾒShow Multiple Rows/Columnsﾓ and ﾒShow Aliases Folderﾓ must be checked), this option will be greyed out.
  214.  
  215. Update icon list
  216. Will re-parse your configuration folder and update all links.
  217.  
  218. About HandyMan
  219. Guess what...
  220.  
  221.  
  222. 8.    About the Program
  223.  
  224. HandyMan is ｩ 1995-96 Bert Wynants.  The current version 1.4
  225.  
  226. This program is freeware (although a postcard is appreciated), this means that you can copy it freely as long as you don't ask any more money for it than a nominal fee for copying.  If you want to distribute this program you should keep this document with it.  This program cannot be used for commercial purposes without written permission from the author.
  227.  
  228. HandyMan has proven to be stable in everyday use.  The author is not responsible for any loss of data, damages to software or hardware that may result directly or indirectly from the use of this program.  The author reserves the right to make changes to the software or documentation without notice.
  229.  
  230. None of the files of the HandyMan package may be modified.  Crunching or archiving is allowed only if none of the HandyMan files get modified by it.
  231.  
  232. Special permission is hereby granted to include HandyMan in Public-Domain libraries.
  233.  
  234. If you translate the program and send the translated version to me.  I will use that translated version in new releases.
  235.  
  236.  
  237. 9.    About the Author
  238.  
  239. Bugs, questions, or suggestions to:
  240.  
  241. Fido
  242.     2:292/603.76
  243.  
  244. Internet e-mail
  245.     bert.wynants@innet.be
  246.  
  247. HomePage:
  248.     http://www.club.innet.be/~ind0836/
  249.  
  250. snail-mail:
  251.     Bert Wynants
  252.     Hogeheide 6
  253.     2260 Westerlo
  254.     Belgium, Europe
  255.  
  256. 10. Acknowledgements
  257.  
  258. ･ Aaron D. Ruiz, Aron S. Spencer, Boris Klug, Brian Renken, Kees Van Wijk, Christopher Li, David D. Kilzer, Drew Wade, Hans Verhoeven, Harry Ehrlich, Jan Dockx, Jeremy Keens, Karl Allison, Mason Loring Bliss, Michael Kisor, Michele Pizzi, Panos Philippakopoulos, Patrick Merel, Peter Frings, Steve Russillo, Steve Levinson and Wesley Summers for beta testing.
  259.  
  260. ･ Wesley Summers for reworking and correcting the readme, history and examples text files!
  261.  
  262. ･ Ammon Skidmore for all the help and for Extensions Strip.
  263.  
  264. ･ Hisashi Nishimura and Michele Pizzi for all the work on the translated Readmes.
  265.  
  266. ･ Christopher Li, Boris Klug, Michele Pizzi and Panos Philippakopoulos for the Catalog Files.
  267.  
  268. ･ All those who have sent me a postcard!
  269.  
  270. 11.    Frequently Asked Questions (FAQs)
  271.  
  272. Q.1:    Why doesn't drag and drop work?
  273. A.1:    Your system does not have the Macintosh Drag and Drop 1.1 extension, or your Finder isn't drag and drop aware.  You should upgrade to at least Finder version 7.1.2 for the PowerMac or 7.1.3 for 68k Macs.  Finder 7.1.3 comes with System 7 Pro, and Finder 7.1.4 comes with Mac OS version 7.5.  If you do not have the correct software, you will not be able to drag Finder icons onto other icons.  If you try, the icons will not highlight when you drag over them, and nothing will happen when you drop something on an icon.  You can get Mac Drag & Drop 1.1 via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.
  274.  
  275. Q.2:    Do I (really) need the scriptable Finder?
  276. A.2:    No, but if your system lacks the Scriptable Finder, some varieties of icons will not work.  In fact, they usually won't be added to the strip.  Folder icons, Trash icons, Control Panel icons, and ordinary documents require the Scriptable Finder in order to be fully operational.  The Finder Scripting extension 1.2 comes with Mac OS version 7.5, or you can get it via anonymous ftp at ftp.support.apple.com/pub/Apple SW Updates/US/mac/System Software/Other System Software/.
  277.  
  278. Q.3:    You seem to indicate in the ReadMe file supplied with HandyMan that it is possible to have a number of folders (1,2 etc), in the Control Strip Module folder, with individual copies of HandyMan and HandyMan Aliases folders.
  279. A.3:    Yes this is possible.  And each copy of HandyMan will run on it's own floating Window with it's own preferences.  However you need to have either Desktop Strip or Extensions Strip for this to work.  See the Tips And Tricks section for more information.
  280.  
  281. Q.4:    I'm running a PowerMac native Extensions Strip, and HandyMan seems to crash.
  282. A.4:    This should be fixed with HandyMan version 1.3.  However, try to use your favorite resource editor to remove the ﾔSdevﾕ resource from HandyMan.  Now Handyman is no longer fat and will run in 68k mode.
  283.  
  284. Q.5:    I noticed that my hard disks keep spinning a very long time just after (or during) startup.  This does not happen if I de-install HandyMan.  I'm using it with Desktop Strip on a Quadra 700 running D-7.5.1.  It doesn't seem to be that severe on a Power Mac 7100/66av where I also tested it.  Is this known? Is there any remedy?
  285. A.5:    After startup, Handyman uses an idle time mechanism to get some more information about your installed applications.  It goes out looking at what file types an application can open, so only drops of that kind are accepted.  It uses the translation manager to do so, and if the Translation manager is not available, it uses a fall-back method.  However this fall-back is not as fast as the Translation manager, so make sure Macintosh Easy Open is installed.  
  286.  
  287. Q.6:    Why can't I select ﾒAdd Row/Columnﾓ from the Configuration menu?
  288. A.6:    Be sure you have selected ﾒShow Multiple Rows/Columnsﾓ and ﾒShow Aliases Folderﾓ from the Configuration menu.
  289.  
  290.  
  291. 12.    Tips And Tricks
  292.  
  293. ･    1.  If the option key conflicts with Control/Desktop/Extensions Strip, press the mouse button first, then press the option key.
  294.  
  295. ･    2.  To differentiate between folders, you can give them a label color in the Finder.  Give folders that have the same icon a different label color in the Finder.  HandyMan will display the icon in the same manner as the Finder after the icon display is updated.  Select ﾒUpdate icon listﾓ from the Configuration menu to update your HandyMan display immediately.
  296.  
  297. ･    3.  As long as there are generic icons for documents or applications, HandyMan watches Disk Inserts and tries to get the icons from the desktop database of the inserted disks.  If you have applications or documents that really have a generic icon you should paste a custom icon onto them to stop HandyMan scanning inserted disks (although it won't hurt watching the Disks).
  298.  
  299. ･    4.  Put a HandyMan floating strip over your Trash, containing only a Trash, and configure it to show large icons.  No more digging to find your Trash!
  300.  
  301. ･    5.  To quickly spot a frequently accessed recent file, make it locked in the ﾔRecent Documentsﾕ folder, HandyMan will underline it in the popup menu.  Also see Known problem 2.
  302.  
  303. ･    6.  If HandyMan tells you it is unable to resolve an alias, you can try to do ﾔFind Originalﾕ in the Finder Info window for that alias.  This often fixes the problem.
  304.  
  305. ･    7.  Use spaces at the start of selected names to sort your items.  These spaces are not shown in the InfoBar, PopInfo and TextLabels.
  306.  
  307. ･    8.  Add the example Separator to the strip (not an alias to it!!!).  This entry won't be clickable but gives you a nice separation bar.  To position it, just give it a name that sorts between the two icons you want to separate.
  308.  
  309.  
  310. 13.    Known problems
  311.  
  312. 1.    Never put locked aliases into the ﾔRecent files/folders/serversﾕ folders from ﾔApple Menu Optionsﾕ with versions prior to Mac OS version 7.5.3.  It will crash your system!
  313.  
  314. 2.    Dragging an icon from HandyMan on a drag-able window of the current application or over the desktop when the Finder is in front fails (Drag Manager bug).  I didn't remove the ﾒEnable Drag Awayﾓ option because dragging an icon from handyman works very well if you stay in the strip, and can be useful to drop it onto one of the handyman icons (e.g.  the Trash).  Due to this problem, dragging should currently be confined to within the strip module.  This problem does not occur when using Extensions Strip.